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Chapter 1 Introduction 


1.1 Before You Begin 


This manual describes the functionality of the AdvaCommand X Workplace Server option, 
which is part of the Advant Station 500 Series Operator Station (AS 5000S) software. 


The AdvaCommand X Workplace Server option provides functionality for running up to three 
additional workplaces in X-terminal windows residing within the TCP/IP network. 


1.2 Equipment Requirements 
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The primary memory has to be extended with 16 Mbyte RAM extra per connected 
X-Workplace. For additional hardware information (for the equipment and environmental 
requirements for the Advant Station 500 Series Operator Station) see the manuals Advant 
Station 520/B132L Hardware Reference Manual and Advant Station 520i/B132 Hardware 
Reference Manual . 


For information regarding X-terminals delivered from other vendors, refer to the documentation 
accompanying those terminals. 
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1.3 How to Use This Book 


This book is organized into chapters and sections as shown in Figure 1-1. 


Chapter 
Configuration/ Buntine 
Application 
Introduction Installation Building Operation Maintenance Appendices Index 
Before You Installation Considerations Operating Preventative 
Begin Procedures Overview Maintenance 
; Capacity & 
Equipment Shut-down Performance Operating Hardware 
Requirements Procedures cae Instructions Indicators 
Application 
ae 0 Bee See Start-up Error 
is Boo 

| rocedures Application Messages 
Conventions Procedures Fault Finding 
Related Configuration/ and User 
Documentation Application Repair 
Release Building Menus x 
History : 

Section 

Terminology 
Product 
Overview 


User Interface 
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Figure 1-1. Organization of Manual 
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1.4 Conventions 


The following conventions are used throughout this manual for the presentation of material: 


° The words in proper names of screen elements (for example, the title in the title bar of a 
window, the label for a field of a dialog box) are initially capitalized. 


° The names of keyboard keys are boldfaced. 


— Initial capital letters are used for the name of a keyboard key if it is labeled on the 
keyboard. For example, the Return key or <Return>. 


— Lowercase letters are used for the name of a keyboard key that is not labeled on the 
keyboard. For example, the space bar, comma key, and so on. 


— In descriptions, the word “key” is used in conjunction with its name. For example, 
pressing the Return key initiates the process. 


— In tables and procedures, angle brackets replace the word “key.” For example, press 
<Return>. 


— A dash is used to indicate that you must simultaneously press several keys. For 
example, <Ctrl-C> indicates that you must hold down the Control key while 
pressing the C key. 


— The phrase “press and release” is used to indicate that you sequentially press several 
keys. For example, to close a window, press and release <Alt>, and then <F4>. This 
indicates that you press and release the Alt key, and then you press and release the F4 
function key. 


° The names of push and toggle buttons are boldfaced. 


— Initial capital letters are used for the name of a push or toggle button labeled on the 
display. For example, the OK button. 


—  Indescriptions, tables and procedures, the word “button” is used in conjunction with 
its name. For example, pressing the OK button initiates the process. 


° The names of menus and menu items are boldfaced. 


— Initial capital letters are used for the name of menus listed in the menu bar. For 
example, the File menu. 


— Initial capital letters are used for the name of menu items. For example, to open a new 
window, choose New from the File menu. 


° System prompts/messages are shown in the Courier font, and user responses/input are in 
the boldfaced Courier font. For example, if you enter a value out of range, the following 
message is displayed: 


Entered value is not valid. The value must be 0-30. 


In a tutorial, you may be told to enter the string TIC132 in a field. The string is shown as 
follows in the procedure: 


TIC132 
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1.5 Related Documentation 


Table 1-1 lists all documentation related to the AdvaCommand X Workplace Server option. 


Table 1-1. Related Documentation 


Category Title Description 

Hardware Advant Station 520/B132L Hardware This book provides instructions for hardware 

Reference Manual setup and installation of the Advant 
Station 520/B132L. 

Advant Station 520i/B132 Hardware This book provides instructions for hardware 

Reference Manual setup and installation of the Advant 
Station 520i/B132. 

Software AdvaCommand Basic Functions User’s Guide | This book give a detailed description of all 

basic functions in AdvaCommand, including 
User Interface, Event and Alarm, and System 
Status. 

Options AdvaCommand Process Sectioning User’s This book provides instructions for accessing, 
Guide and using all Process Sectioning functions. 
AdvaCommand Status List User’s Guide This book provides instructions for accessing, 

and using all Status List functions. 
AdvaBuild Display Builder User’s Guide This book provides instructions for accessing, 
and using all Display Builder functions. 
AdvaBuild On-line Builder User’s Guide This book provides instructions for accessing, 
and using all On-line Builder functions. 

Other For information regarding X-terminals delivered from other vendors, refer to the documentation 

accompanying those terminals. 
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1.6 Release History 


Table 1-2 give a short description of what is new in the AdvaCommand X Workplace Server 
option in the latest versions of the Advant Station 500 Series Operator Station. 


Table 1-2. Release History 


Version Description 


1.6 This release provides the new function, AdvaCommand X Workplace 
Server, which allows the user to connect an X-terminal or a PC that 
emulates the X protocol, to the TCP/IP network and use it as an 
ordinary operator station. 


1.7 This release allows the user to connect up to three X-terminals or 
PC’s that emulates the X protocol, to the TCP/IP network and use 
them as ordinary operator stations. 


1.7 Terminology 


The following is a list of terms associated with Advant Station 500 Series Operator Station that 
you should be familiar with. 


Term Description 


Pointer The pointer is an upper left pointing arrow which indicates where 
operator input is entered on the screen. For instance, use the 
pointer to indicate the display button you want to select when you 
click the mouse button or the field to which you want to input 
information via the keyboard. 


The hotspot of the pointer is the upper tip of the arrow. You 
manipulate the pointer via a mouse, trackball or keyboard. 


The pointer appears as a cross in base and overlap displays in 
runtime. 


Selecting Objects You select an object on the display by positioning the pointer over 
the object and pressing the left mouse button or pressing the key 
Select (on the trackball or keyboard). Only a single click or press 
is required to make a selection. 


Keyboard Focus More than one window can be displayed at the same time; 
however, only one window is active at a time. Keyboard focus 
determines which area of the screen or which element in a 
window receives input from the keyboard. The active window is 
indicated by highlighted window borders and a title bar. 
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Term 


Buttons 


Menus 


Description 


All buttons are depicted as raised above the plane of the screen. 
When a button is pressed, it appears lower than the plane of the 
screen. All areas of the screen that cannot be selected appear flat 
(that is, in the plane of the screen). 


When configuring, you use pull-down menus and pop-up menus. 
The pull-down menus are usually placed in a menu bar. A pop-up 
menu is displayed directly below the button you use to select it, 
and the menu remains open until you take an action or explicitly 
close the menu. The menu does not require you to keep the mouse 
button depressed until you locate and select the desired item. 


No menus are used for runtime operation. 


The following acronyms are used in this document: 


Acronym 
OCS 


AS 5000S or 
Operator Station 


TCP/IP 


XDM 


X-terminal 
X Workplace 
HP X terminal 


Description 
Open Control System 


Advant Station 500 Series Operator Station 


Communication network (Transmission Control 
Protocol/Internet Protocol) 


X Display Manager. Program that enables client to start 
automatically at log in. 


External terminal used as an additional workplace. 
Operator workplace with an X-terminal. 


Product from HP supporting X-terminals. 
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1.8 Product Overview 


1.9 User Interface 
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This manual provides an overall description of the X Workplace functionality. It is intended for 
the engineering people who will implement and maintain the X Workplace and the operators 
who will run X Workplace. 


The X Workplace functionality is identical to that of the Operator Station with some exceptions, 
which are described in this manual. One main difference is that the X Workplace do not have 
exactly the same system configuration capabilities. Another is that the operator keybord can not 
be connected to the x-terminal, so the specific operator function keys in the operator keyboard 
are handled on the screen with the mouse and the pop-up menus. 


The AdvaCommand X Workplace Server option enables you to run the Operator Station in an 
X-terminal window on any foreign computer supporting X server functionality and connected to 
an Advant Station 500 Series Operator Station via the TCP/IP network. 


The functionality can be divided into two parts: 
° Openness 


An open environment requires that most information in the system is accessible. Advant 
Station 500 Series Operator Station displays and most of the configuration tools are 
therefore accessible from an X-terminal. In terms of openness, this also means that you can 
use other vendors terminals when connected via TCP/IP to an Advant Station 500 Series 
Operator Station. 


° Low cost workplace 


Advant Station 500 Series Operator Station provides one workplace per station. An 
X-terminal is an economical alternative to purchasing another Advant Station 500 Series 
Operator Station. The X-terminal enables you to create a low cost workplace while 
maintaining control of the process. 


User interfaces provided are the same as those provided for Advant Station 500 Series Operator 
Station. For further information, see the AdvaCommand Basic Functions User’s Guide. 
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Chapter 2 Installation 


2.1 Installation Procedures 


When your Operator Station is delivered, the AdvaCommand software is already installed. In 
addition, all the software options you have ordered (for example, AdvaBuild Display Builder) 
are also installed. 


For a description of installation from DAT, for example after a disk exchange, see the Release 
Notes supplied with the product. 


To determine how to connect the DAT-drive to the Operator Station, see the appropriate 
hardware manual (the Advant Station 520/B132L Hardware Reference Manual and the Advant 
Station 520i/B132 Hardware Reference Manual). 


Should you order other software options later, instructions on how to install those options are 
delivered with that software. 


2.2 Shutdown Procedures 


Refer to the Release Notes supplied with the product for information on shutdown procedures. 
For information regarding shutdown procedures for X-terminals delivered from other vendors, 
refer to the documentation accompanying those terminals. 


2.3 Start-up Procedures 


Refer to the Release Notes supplied with the product for information on start-up procedures. For 
information regarding start-up procedures for X-terminals delivered from other vendors, refer to 
the documentation accompanying those terminals. 


3BSE 008 338R0101 2-1 


AdvaCommand® X Workplace Server User’s Guide 
Chapter 2 Installation 


2-2 3BSE 008 338R0101 


AdvaCommand® X Workplace Server User’s Guide 
Section 3.1 Considerations 


Chapter 3 Configuration/Application Building 


3.1 Considerations 


3.1.1 Availability 


You can connect up to three X-terminals to an Advant Station 500 Series Operator Station with 
the AdvaCommand X Workplace Server option, on the same TCP/IP network. The availability is 
ruled by three parameters: 


° Availability of Advant Station 500 Series Operator Station with 
AdvaCommand X Workplace Server option 


° Network availability 


° PC or X-terminal hardware/software availability. 


NOTE 


After a functional restart of Advant Station 500 Series Operator Station, a new 
connection must be established with the X-terminal. 


3.1.2 Authority 


You cannot control authority in the X Workplace using the functional keyboard Authority key, 
as you can in the Advant Station 500 Series Operator Station. Instead, you use a pop-up menu to 
change authority. The authority to set maximum dialog is controlled by a password. The default 
authority at login is minimum dialog. 


Provided the user knows the password, it is possible to toggle between maximum dialog (Max 
dialog) and minimum dialog (Min dialog) from the pop-up menu. The password is configurable. 


When the cursor is outside a display element and you press the right mouse button, a pop-up 
menu appears on the screen. There are two choices defined for authority, Max dialog and Min 
dialog. When you choose Max dialog, a password dialog box appears. 


=| Password Dialog 


Password: 


OK Cancel Help | 


Figure 3-1. Password Dialog Box 
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3.1.2.1 Change Password 


The password for the Max dialog is possible to configure. All workplaces can have different 
passwords. The default password on the Advant Station 500 Series Operator Station is 
aosmaxd0, on the first X Workplace (wp3) aosmaxd3, on the second (wp4) aosmaxd4 and on 
the third (wp5) aosmaxd5. 


To change the default password on the first X Workplace (wp3) do as follows: 


iB 


a 2 a a ce 


Bring up a terminal window from the configuration dialog, that is select the subitem 
System Config from the pop-up menu Operation, then select the screen button D7 
Station... 


Log in as user root: 

a. Enter the command su root and press <CR>. 

b. Enter the root password (default at delivery: vm-guld) and press <CR>. 
Enter the command passwd aosmaxd3 and press <CR>. 

Enter a new password and press <CR>. 

Confirm the new password and press <CR>. 

Enter exit to logout from root. 


Close the terminal window. 


To change the password for X Workplace 2 and 3, exchange aosmaxd3 with aosmaxd4 and 
aosmaxd5 in the above description. The default password for the Advant Station 500 Series 
Operator Station is aosmaxd0. 


3.1.3 Screen Resolutions 


3-2 


While the AdvaCommand X Workplace Server option can be run on several screen resolutions, 
display geometry and font sizes are adopted to support the following resolutions. Other 
resolutions could impact the appearance of displays and fonts. 


Supported screen resolutions are: 


1280 x 1024 (default screen size) 
1150 x 900 

1024 x 768 

800 x 600 
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3.1.4 Fonts 


Fonts used by the AdvaCommand X Workplace Server option must be defined locally on the 
X-terminal where the X server is running. This does not apply to you if you are using HP 
X-terminals, since necessary fonts are loaded with the boot software. 


To run the Operator Station with the correct fonts, the fonts named FA and FC—which are 
described in the disk file /products/data/standard/OS/config/fontdef.dat—must be defined 
locally. 


Other fonts described in that file are not used by the standard system, but can be used for 
adaptations or as desired by customers. 


3.1.5 Colors 


To guarantee that every color used by the AdvaCommand X Workplace Server option is 
presented correctly, your X-terminal or PC should have 133 free colors available. If 133 colors 
cannot be allocated, approximations are made which can affect the colors. 


Under normal conditions, it does not make sense to run an AdvaCommand X Workplace Server 
option on a system with less than 64 available colors. 


3.1.6 Standard Compliance 


The interface between Advant Station 500 Series Operator Station and the X Workplace 
complies with X windows protocol. TCP/IP is used as communication protocol. 


3.2 Capacity and Performance 


Through the option AdvaCommand X Workplace Server presentation of a lot of displays on 
several screens at the same time is possible. There is, of course, a limitation on what the Advant 
Station 500 Operator Station is capable of handling simultaneously. Due to the number of 
parameters to consider when building and presenting a display, it is very difficult to give an 
unambiguous advise or formula. 


One critical point is the number of simultaneously presented dynamic objects. A rough advise 
is, not to simultaneously display a total of more than 1000 objects on all connected X-terminals. 
To help avoiding performance problems the number of overlap displays are restricted to 2 on an 
X-workplace and 5 on the local workplace. Also the number of objects within a display is 
recommended not to be more than 100 if three X-terminals are used. The same recommendation 
is valid for both base and overlap displays when using the X Workplace Server option. 


Another problem might arise if display exchanges are requested at the same time on all 
workplaces. In this unlikely situation a high load on the communication components in the 
system will occur, with longer display exchange times as a result. 
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3.3 Application Start-up 


3.3.1 Start-up 


3-4 


There are basically two ways to start the AdvaCommand X Workplace Server. One is to start it 
with XDM (X Display Manager) login and the other is to start it with the start-up script 
dcStartup Workplace. 


° Start-up via XDM login process 


The XDM process is a standardized way you can connect X-terminals to foreign 
computers. It is supported by HP X terminal and different X-emulating software packages 
for PC’s (Personal Computers). 


This login procedure allows you to start the AdvaCommand X Workplace Server with a 
minimum of knowledge about the ABB start script. 


° Start-up via ABB start script 


Use the script deStartupWorkplace to start the Operator Station process and define the 
entire environment necessary for the X-terminal process in the Operator Station. It also 
enables you to define parameters to modify the behavior of the process. See Section 
3.3.1.3, Start-up via ABB Start Script (dcStartup Workplace) for further description of this 
script. 


In the Advant Station 500 Series Operator Station, three types of users who can modify the 
system are defined: 


° standard 

° adaptation 

° customer 

The X Workplace is always running as customer. 


For further information, refer to the AdvaCommand Basic Functions User’s Guide. 
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3.3.1.1 Start-up via XDM Login Process 


3.3.1.2 Login 
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The XDM software is loaded as one part of the file set loaded for the AdvaCommand 
X Workplace Server option. 


The XDM process in the Advant Station 500 Series Operator Station is activated at system start- 
up and is always active. This process is responding to every XDM broadcasted over the TCP/IP 
network, which enables the connecting computer to build a list of computers ready to serve 
XDM login. 


At login, the XDM process in Advant Station 500 Series Operator Station is configured in such 
a way that the login is overtaken by the process in Advant Station 500 Series Operator Station 
and a standard login box is shown on the screen. 


Welcome to <hostname> 


login: 


Password: 


Figure 3-2. Standard Login Box 


Log in as follows: 


1. Move the mouse or press any key on the keyboard and a standard login box is shown 
on the display. 


If you want to start the AdvaCommand X Workplace Server option, log in as user 
customer (X Workplace is always running as customer). By default, no password 
is required. 


2. Enter the user name in the login field and press <CR>. 


3. If you choose to log in as customer (see the previous step) to an Operator Station with the 
AdvaCommand X Workplace Server option loaded, a selection dialog box appears on the 
screen. 
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= X Workplace Server Login 


A, 7 ip 
FADD ED 


Advant Station 500 Series Operator Station 
Version: SW*1.7-0 


Workplace 


Selected Workplace: 
! | 


OK Cancel Help 


Figure 3-3. AdvaCommand X Workplace Server Login Dialog Box 


The login process lets you choose whether to start an X Workplace or open a standard 
terminal window. 


If you choose to start an X Workplace, select one workplace from a list of available 
workplaces on that particular Advant Station 500 Series Operator Station. In this release 
the available workplaces are called wp3, wp4 and wp5. These workplace numbers are used 
because number | and 2 are reserved for the local workplace screens, for example 
FixedDisplay1 is on screen! and FixedDisplay3 is on wp3 etc. 


4. Enter the name of the workplace by clicking on a workplace name in the Workplace field. 
The selected workplace name appears in the Selected Workplace field at the same time. 


5. Select OK in the dialog box and the X Workplace is started using the 
dcStartup Workplace script. 


If you select Cancel instead, a new dialog box asks you for the max dialog password for 
the Advant Station 500 Series Operator Station (default password is aosmaxd0) and then 
starts a standard terminal window on the terminal. 
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3.3.1.3 Start-up via ABB Start Script (dcStartupWorkplace) 


If you want to start an X Workplace without using XDM, there is a script available. This script, 
dcStartup Workplace, serves two purposes: 


° It allows you to start the AdvaCommand X Workplace Server option on a terminal 
supporting X functionality without using XDM. This script is typically used with 
rlogin or remsh commands. 


° It allows some configuration parameters to be sent to the script to control the behavior 
of the Operator Station process, for example the size of the X-terminal window. 


The script, named dcStartupWorkplace, handles the following tasks: 
° Setting up log files 

° Setting up the environment 

° Loading X resources in xdb 

° Starting a window manager 

° Starting the color flash tool 


° Screen size. 

Input 

The conventional way to start the X Workplace is to login to the Operator Station with the rlogin 
command and then enter for example : 


dcStartupWorkplace -display $DISPLAY -workplace wp3 


The following input parameters are defined for the dcStartupWorkplace script: 


Table 3-1. Input Parameters for the dcStartup Workplace Script 


Parameter Option Description 


-workplace workplace name Name of desired workplace 
configuration. There is three 
workplaces available (wp3, 

wp4 and wp5). 


-display value of display variable | Assigns the display variable the 
internet address or name to the 
computer you want to start the 
X terminal on. Example: 
138.221 .22.34:0 or 08 12:0 
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Table 3-1. Input Parameters for the dcStartup Workplace Script (Continued) 


Parameter Option Description 


-mwm none Starts a window manager. This is 
only necessary if no window 
manager is running on the actual 
system. 


-geometry display size Sets the display size. If this 
parameter is omitted, then the 

X Workplace tries to create a 
base display which is as large as 
possible. 


The following screen sizes are 
supported: 


1280x1024 (default value) 
1150x900 

1024x768 

800x600 


Output 


The output from the dcStartupWorkplace script is one Operator Station process and 
one log file. The log files resides in the /products/log directory and are called 
dcSystem_<workplace>.log, where workplace is the name of the workplace (wp3, wp4, wp5). 


If the workplace does not start up an error box will pop up and information should also be 
available in the log file. The X Workplace session will not start if one of the following errors 
occurs: 
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The X server does not allow remote computer to start an X Workplace session 


To remedy this, change the permission for the X server. If you start the X-terminal from 
another AS 5000S or another UNIX computer, using the xhost command with the 

X Workplace Server name as argument, for example xhost as2, will fix the problem. For 
other systems consult your X server documentation on how to enable a remote computer to 
start an X Workplace session. 


The workplace has already been started by another user 


Only one user may be active in one workplace at a given time so you have to start another 
workplace or ask that user to log out. 
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There is not enough free colors in the X server 


Free some colors by stopping other applications. As a last resort you can change the 
needed colors in the color configuration files, but that is NOT recommended since it may 
result in strange color combinations which can result in unreadable text or graphics in 
displays or configuration tools. 


Some parameter to the dcStartupWorkplace script is incorrect 
(misspelled or wrong display parameter) 


If you use the rlogin command to login to the X Workplace server it will automatically set 
up the DISPLAY environment variable in the shell. Perform echo $DISPLAY to see the 
value of that variable and check it against the internet address/name of the computer that 
you are trying to start the X Workplace on. 


To end an X Workplace session, you normally log out from the Operator Station process. Do 
this from the configuration dialog, which has a dedicated key for this function. As a result, the 
started Operator Station process is terminated in a controlled way. 


Logout from the Configuration Dialog: 


1. 


Select the System Configuration dialog from the pop-up menu (the System Config 
subitem in the Operation menu). The following dialog appears: 


D1 


AdvaCommand... 


D2 


AdvaBuild... 


D4 


D5 


D6 


Settings... 


Station... 


Maintenance... 


D9 


D10 


Figure 3-4. Dynamic Function Keys - System Configuration Dialog (in X Workplace) 


Select screen button D7 Station.... The following dialog appears: 


D1 


D2 


Logout 


D4 


D5 


6 
Terminal Window 


D8 


D9 


D10 


Figure 3-5. Dynamic Function Keys - System Configuration Dialog - D7 Station... 
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3. Select screen button D3 Logout. The following dialog box appears: 


=| Workplace logout 


(?) Do You want to logout? 


Yes No 


Figure 3-6. Workplace Logout Dialog Box 


Select Yes to terminate the X Workplace session or No to cancel the request. 


It is also possible to terminate the Workplace session by using the window manager to close it 
down. In mwm do this by selecting Close in the upper left pull-down menu. 


3.3.3 HP X Terminal Start-up 


The AdvaCommand X Workplace Server option is delivered with the software package 
necessary to boot the HP700RX and ENVIZEX X Terminals (both products from HP). In both 
cases, use the Operator Station loaded with this software as file server. 


For more information about these two products, see the appropriate HP manuals delivered with 
the software. 


3.4 Application Procedures 


The X Workplace can be used as an ordinary Advant Station 500 Series Operator Station with 
some exceptions for the configuration tools, see Section 3.5.1, Configuration Tools. 
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3.5.1 Configuration Tools 
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Only configuration tools that do not require physical access to the Advant Station 500 Series 
Operator Station and which do not affect all Workplaces is possible to use from the Advant 
Station 500 Series Operator Station. All tools works as in the Advant Station 500 Series 
Operator Station. The following configuration tools are available: 


Display Builder 

On-line Builder 

RTA Backup 

RTA Maintenance 

Central Backup 

Status List Configuration 
Process Section Configuration 
Terminal Window 

Group Alarm Configuration 
Hardcopy Configuration 
Printer Configuration 
Display Tool 

Display Transfer 

Node Broker 


Object References 


The following configuration tools are not available because they requires physical access and/or 
affects all attached workplaces: 
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Station Backup 
Station Settings 
Date and Time 
Function Restart 
Station Restart 


External Alarm Configuration 
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The following configuration tool is only available in the X Workplace: 


° Logout 


NOTE 


There is no indication between different workplaces about which one of the 
workplaces that has activated the tool(s). Configuration tools should therefore not 
be started from more than one workplace at a time. Configuring the same thing 
from two places can lead to unintended results. 


3.5.1.1 Process Sectioning 


The AdvaCommand Process Sectioning option is a software option which helps you define 
command authority and range of event and alarm presentation in the Operator Station. See the 
AdvaCommand Process Sectioning User’s Guide for a description of this function. 


Different delegations can be active simultaneously in the Advant Station 500 Series Operator 
Station and in the X Workplace. You activate the delegation from the respective workplace. 


For X Workplace, the printer function is limited. You can order printouts of lists and the page 
presented on the display screen, but you cannot log events and alarms on printers. 


3.5.2 External Alarm 


3.5.3 Status List 


An X Workplace cannot be configured to treat any external alarm. External alarms are not 
available on an X Workplace. 


The Status List function is available on an X Workplace. This also means that presentation of 
predefined Status Lists is available from an X Workplace. An X Workplace has its own 
configurable quick list named Quick List 3, Quick List 4 and Quick List 5. 


3.5.4 Display Installer 
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The display installer will not only affect the workplaces it was started from, it will always affect 
all workplaces when used. The display installer will install/uninstall the displays on all 
workplaces in the same Advant Station 500 Series Operator Station. 
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Chapter 4 Runtime Operation 


4.1 Operating Overview 


AdvaCommand X Workplace Server is an option that allows you to run the operator functions 
from three X-terminals or personal computers (PC) emulating an X-terminal. 


7 C 


—— ~ : i melee 
ee ESS ) | LEE) / 6 
HP X Terminal ~~ HP X Terminal ~~ PC 
TCP/IP 
X Client 
AS 5000S 
MasterBus 300 


Figure 4-1, Example of an X Workplace Configuration 


An Advant Station 500 Series Operator Station currently supports one workplace with 
1-2 screens. 
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The X Workplace is intended to be an individual workplace providing the same functionality to 
control the process as the Advant Station 500 Series Operator Station, that is an operator should 
not, besides the login/logout procedure, notice any differences compared to working on the 
Advant Station 500 Series Operator Station. 


NOTE 


Only three X Workplace connected via TCP/IP to an Operator Station is 
supported at a time. The option does not support the functional keyboard and 
trackball used with the Advant Station 500 Series Operator Station. Instead, all 
inputs are given through an ordinary keyboard and a mouse. Configuration is only 
partly supported and can cause interference if started on several workplaces at the 
same time (see Section 3.5.1, Configuration Tools). 


4.1.1 Keyboard Handling 


The Advant Station 500 Series Operator Station functional keyboard is not supported in the 
X Workplace. You can use a standard keyboard without any special configuration. 


You can define keys on the X-terminal keyboard with functionality similar to the keys on the 
functional keyboard. In this way, you can define your own layout of the X-terminal keyboard 
and create your own “functional” keyboard. 


See Appendix A, Keyboard Functions for a short description of all the events for the specific 
Advant Station 500 Series Operator Station functions and the Keysym names for most common 
keypad keys. 


How to Configure the Keyboard 
There are two keyboard files of interest: 
e FunctionHPKeyboard.dat 
Used if the X server has HP emulation. 
e FunctionKeyboard.dat 


Used if the X server has emulations other than HP emulation. 


These files are placed under 


/products/data/standard/OS/config/ 


To configure the keyboard for some or all events, copy the file(s) to 
/products/data/adaptions/OS/config/ or 


/products/data/customer/OS/config/ and edit. 
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The files contain the events for specific Advant Station 500 Series Operator Station functions. 
Only the events for the dynamic function keys are currently configured. Every event contains 
Keysym, Keyboardtype and Modifiers. 


Keysym Replace VoidSymbol in Keysym, in the file, to the value of the key to be 
configured. 


Keyboardtype Already defined. 


Modifiers = None means that only the key has to be pressed 
= Shift means that <shift> key has to be pressed 
= Control means that <ctrI> key has to be pressed. 
DisplayMenuKey = Event DisplayMenuKey = Event 
Keysym = VoidSymbol Keysym = VoidSymbol 
Keyboardtype = 206 Keyboardtype = 0 
Modifiers = None Modifiers = None 
} 
FunctionHPKeyboard.dat FunctionKeyboard.dat 


Figure 4-2. Part of the keyboard files FunctionHP Keyboard.dat and FunctionKeyboard.dat 


Example: 


We want to configure the keyboard so that the display menu appears when the key with the 
star, *, is pressed on the keyboard. The X server does not have HP emulation. To achieve this, do 
as follows: 


1. Copy the keyboard file FunctionKeyboard.dat from /products/data/standard/OS/config/ 
to /products/data/adaptions/OS/config/. 


2. Open the keyboard file. 


3. Set Keysym=KP_Multiply for the event DisplayMenuKey (see Section A.2, Keysym for 
the most common Keypad Keys). 


4. Save the keyboard file. 


5. Make a function restart. 
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4.2 Operating Instructions 


4.2.1 Pop-up Menus 


To make it possible to control the process from an X Workplace, all the functionality of the 
functional keyboard has been transferred to a pop-up menu. You can reach this menu via the 
mouse. 


You can use the pop-up menu both in the Advant Station 500 Operator Station and in an 
X Workplace. 


When you press the right mouse button, one of the two types of pop-up menus, Operation and 
Object Handling, appears. 


Which menu appears on the screen depends on the cursor’s position on the screen. If the cursor 
is placed on an object, the Object Handling menu appears. Otherwise, the Operation menu 
appears. 


To select one of the items use drag and drop. 

There are three different kinds of events behind an item when it is selected. 
One with: 

° Direct Command 

° Submenu with subitems (indicated with an arrow) 

° Dialog box (indicated with ‘ ...”) 


In the pop-up menu, you can select three different types of dialog boxes (Box, Row and 
Column). The dialog boxes contains items from the Operation menu and the Object 
Handling menu. 


The difference between the pop-up menus and the dialog boxes is that the dialog boxes do 
not disappear when a button is pressed or a display change occurs. 


4.2.1.1 Operation menu 
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This menu takes care of all functionality concerning display change. 


If the cursor is placed outside a display element of an object, then the pop-up menu concerning 
display change occurs when you press the right mouse button. 
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Operation 


Silence 
Dialog Exit 


Close Overlaps 

Previous Display 

Display Request 
Overlap Display Request 
Right Display 

Left Display 

Direct Selection Box... 


Dialog Navigation Keys 
Display Keys 

System Display Keys 
Operation Keys Box... 
Operation Keys Row/Column... 


VVV 


Previous Object 

Object Request 

Closeup Request 

Hardcopy > 
| Max Dialog 


Figure 4-3. Pop-up menu Operation for Display Change 


Silence Silence an audible alarm or an external audible alarm. 

Dialog Exit Exit from the selected dialog. 

Close Overlaps Close all overlap displays. 

Previous Display Toggle between the display presently on the screen and the 
display most recently called up on the screen. 

Display Request Call up a base display by selecting this item and then type the 
display name. 

Overlap Display Call up an overlap base display by selecting this item and then 

Request type the display name. 

Right Display Go forward as many pages as there are in a base display, list or 


menu. You can also page to a chained display. 


Left Display Go backwards as many pages as there are in a base display, list or 
menu. You can also page to a chained display. 
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Direct Selection Box... Call up the Direct Selection Keys box. This box contains 
buttons for 40 direct selection keys. Each button has 
a key label from the display builder. 


This dialog box disappears when a button is pressed. 


=| Direct Selection Keys 
Key Shift Key 
1: MBC node 11 s1 21: 
2: MBC node 11 s2 22: 
3: 23: 
4: MasterBatch Process Overview | 24: 
5: 25: 
6: 26: 
7: 27: 
8: 28: 
9: Vuepad Editor 29: 
10: 30: 
11: HPterm 31: 
12: 32: 
13: 33: 
14: 34: 
15: 35: 
16: 36: 
17: 37: 
18: 38: 
19: 39: 
20: 40: 


Figure 4-4. Direct Selection Keys Dialog Box 
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Call up a submenu with two subitems for navigation between the 


function key sets in the process dialogs. 


Operation 


Silence 
Dialog Exit 


Close Overlaps 

Previous Display 

Display Request 
Overlap Display Request 
Right Display 

Left Display 

Direct Selection Box... 


Display Keys > 
System Display Keys > 
Operation Keys Box... 
Operation Keys Row/Column... 


Next Dialog Block 
Previous Dialog Level 


Previous Object 
Object Request 
Closeup Request 


Hardcopy > 
|] Max Dialog 


Next Dialog Block 


Previous Dialog Level 


previous dialog. 


Figure 4-5. Dialog Navigation Keys items in the Operation pop-up menu 


Presents the next dynamic function key set in the dialog. 


Presents the dynamic function key set on the top level of the 
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Call up a submenu with six subitems to control the selected 


Display Keys can be displayed as an overlap display. 


Display Keys 
display menu or list. 
Operation 
Silence 
Dialog Exit 


Display Menu 


Overlap Display Menu 


Alarm List 


Overlap Alarm List 
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Close Overlaps 

Previous Display 

Display Request 
Overlap Display Request 
Right Display 

Left Display 

Direct Selection Box... 


Dialog Navigation Keys > 


System Display Keys be 
Operation Keys Box... 
Operation Keys Row/Column... 


Previous Object 
Object Request 
Closeup Request 


Display Menu 


Overlap Display Menu 


Alarm List 


Overlap Alarm List 


Event List 


Overlap Event List 


Hardcopy > 


_] Max Dialog 


Figure 4-6. Display Keys items in the Operation pop-up menu 


Call up the display menu. Use this item to call up a menu 


containing the display libraries. After you have selected a library, 
all installed displays within the library are listed. 


Call up the display menu as an overlap display. 


Call up the alarm list. The last page in the alarm list is displayed. 
With the items Previous Display, Right Display and Left 
Display you can go through the whole list. The list contains the 


last 500 alarms. 


Call up the alarm list as an overlap display. 
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System Display Keys 
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Call up the event list. The last page in the event list is displayed. 
With the items Previous Display, Right Display and Left 
Display you can go through the whole list. The list contains the 
last 1,000 events. 


Call up the event list as an overlap display. 


Call up a submenu with six subitems to control system displays. 
Three are used to control and monitor system status and alarms, 
one is to start configuration and maintenance functions, and two 
are used for the software option AdvaCommand Status List. 


System Display Keys can be displayed as an overlap display. 


Operation 


Silence 


Dialog Exit 


Close Overlaps 

Previous Display 

Display Request 
Overlap Display Request 


Right Display 
Left Display 
Direct Selection Box... 
Dialog Navigation Keys > 
Display Keys > 
em Display Ke System Status 

Operation Keys Box... System List 
Operation Keys Row/Column... Overlap System List 
Previous Object Status List 
Object Request Status List Menu 
Closeup Request System Config 
Hardcopy | Help 

|_| Max Dialog 


Figure 4-7. System Display Keys items in the Operation pop-up menu 


System Status 


System List 


Presents the status of all nodes (Process and Operator Stations), 
the I/O boards, peripheral devices and communication links. Use 
this item primarily to monitor and troubleshoot in the system. 


Presents system alarms related to the control system. Use this 
item primarily to monitor and troubleshoot in the system. 
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Overlap System List 
Status List 
Status List Menu 


System Config 


Help 


Operation Keys Box... 


Presents the system list as an overlap display. 
This item is used for the AdvaCommand Status List (option). 
This item is used for the AdvaCommand Status List (option). 


Call up a menu from which you can start configuration and 
maintenance functions. 


Call up a help display if such a display has been assigned to a base 
display. The help display is always an overlap display. 


Call up a box with buttons for the items and subitems from the 
Operation and Object Handling menus. 


=| Operation Keys 
Close 
Tat [|G OS] oer |i is >| 
laps 
Event can Prev 
List | g Obj, 
4 Ob ject ; 
Display Page Dialog sr 
Menu 7 —_> 
+; p 
; Dialog 
oO oe Object Exit 
ap 


Figure 4-8. Operation Keys Box 


Call up the alarm list. The last page in the alarm list 


Ale Alarm List is displayed. 


List 


Display 
Menu 


Call up the event list. The last page in the event list 


Event Event List is displayed. 


Call up the display menu. Call up a menu 


Display Menu containing the display libraries and then select a 


library, all installed displays within the library are 
listed. 
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Overlap 


lop (Togglebutton) 


Previous Display 


in 
Trend Display 


Object Object Display 


oes Close Overlaps 


Close Object Closeup 


[q— Left Display 
Didlog Previous Dialog Level 


Dialog Next Dialog Block 
— 


—B] Right Display 
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Overlap is tied to five buttons with a black corner in 
the Operation Keys box. When it is set and one of 
the items is selected, the display will be displayed 
as an overlap. 


Toggle between the display presently on the screen 
and the display most recently called up on the 
screen. 


Call up the trend display for a marked process 
object. 


Call up the object display for a marked process 
object. 


Close all overlap displays. 


Call up the object display for a marked process 
object as a closeup display. 


Go backwards as many pages as there are in a base 
display, list or menu. You can also page to a chained 
display. 


Presents the dynamic function key set on the top 
level of the previous dialog. 


Presents the next dynamic function key set in the 
dialog. 


Go forward as many pages as there are in a base 
display, list or menu. You can also page to a chained 
display. 
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Operation Keys 
Row/Column... 


Previous Object 


Acknowledge 


Dialog Exit 


Call up the process dialog for the object previously 
selected. 


Acknowledge the alarm by positioning the cursor 
on the object name or symbol and select the 
Acknowledge item. 


Exit from selected dialog. 


Call up a box with buttons for the items and subitems from the 
Operation and Object Handling menus arranged either in a row or 
in a column. 


The buttons available are the same as in the Operation Keys box, 
but there is also a small button to change the box between Row 
and Column format. 


Operation Keys | 


L] Over 
lap 


Display Alarm Event Object 
Menu Lis List 


Object 
Close 
up 


Close 
Sal ¢ |)a-||2 
laps 
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MN 
Te 


Dialog 
— 


Y 


Dialog 
Exit 


Figure 4-9. Operation Keys Box arranged in a row 


Column 


Column 
(Togglebutton) 


Switch from the Operation Keys box arranged as 
a row to the box arranged as a column. 
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Ope Close 
Over 
L] Over laps 
lap 
Display [<— 
Menu 
Alarm > 
List 
Event Dialog 
List 
Dialog 
Ob ject —> 


Row 


Figure 4-10. Operation Keys Box arranged in a column 


Row 


Row Switch from the Operation Keys box arranged as 
(Togglebutton) a column to the box arranged as a row. 
Previous Object Call up the process dialog for the object previously selected. 
Object Request Select this item, then type the object name. 
Closeup Request Select this item, as an overlap display, then type the object name. 
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Hardcopy Call up two subitems, Hardcopy 1 and Hardcopy 2, to select from 
when printing the screen on a hardcopy printer. 
Operation 
Silence 
Dialog Exit 
Close Overlaps 
Previous Display 
Display Request 
Overlap Display Request 
Right Display 
Left Display 
Direct Selection Box... 
Dialog Navigation Keys > 
Display Keys > 
System Display Keys be 
Operation Keys Box... 
Operation Keys Row/Column... 
Previous Object 
Object Request 
Closeup Request 
Hardcopy | Hardcopy 1 
| Max Dialog Hardcopy 2 
Figure 4-11. Hardcopy items in the Operation pop-up menu 
Hardcopy 1 Used for printout of the screen. 
Hardcopy 2 Used for printout of the screen. 
[|] Max Dialog Call up the the dynamic function key set for the maximum dialog 
(Togglebutton) to give the user full authorization. It is controlled by a password. 
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Use this menu when you are operating a process object. 


If you place the cursor on a display element and press the right mouse button, the menu 
concerning process object handling appears. 


Object Handling 
Acknowledge 
Object Display 
Overlap Object Display 
Object Trend 
Overlap Object Trend 
Object Closeup 


Object Control > 


Figure 4-12. Pop-up menu Object Handling for Process Object Control 


Acknowledge 


Object Display 


Overlap Object 
Display 


Object Trend 
Overlap Object Trend 


Object Closeup 
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Acknowledge the alarm by positioning the cursor on the object 
name or symbol, press the right mouse button and select the 
Acknowledge item in the Object Handling menu. 

Process alarms that are active in the process have a red flashing 
light. 

To silence an audible alarm or an external audible alarm, select 
the Silence item in the Operation menu or select the icon in the 
screen header. 


Call up the object display for a marked process object. 


The display contains all the information available about the 
object. The display layout is the same for all objects, but its 
contents varies depending on the object type. If you select the 
object, the dialog to control the object is also displayed. 


Call up the object display for a marked process object as an 
overlap display. 


Call up the trend display for a marked process object. 


Call up the trend display for a marked process object as an overlap 
display. 


Call up the closeup display for a marked process object. 
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Object Control Call up 10 subitems for the basic operations of the selected 
process objects. 


Object Control can be displayed as an overlap display. 


Object Handling 
Acknowledge 
Object Display 
Overlap Object Display 
Object Trend 
Overlap Object Trend 
Object Closeup 


Obje ontro Man Auto 

E1 E2 

Small Decrease Small Increase 
Large Decrease _ Large Increase 
Off On 


Figure 4-13. Object Control items in the Object Handling pop-up menu 


Man Change mode to manual control. 

Auto Change mode to auto control. 

E1 Change mode to external control E1. 

E2 Change mode to external control E2. 

Small Decrease Decrease the present output value by 1%. 
Small Increase Increase the present output value by 1%. 
Large Decrease Decrease the present output value by 10%. 
Large Increase Increase the present output value by 10%. 

Off Turn off valves, switches, motors, pumps, etc. 
On Turn on valves, switches, motors, pumps, etc. 
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4.2.2 Hardware Interfaces 


Advant Station 500 Series Operator Station acts as an X client for the AdvaCommand X 
Workplace Server function. You can execute the X server part required for the X Workplace in a 
dedicated X-terminal, in another X-based host or through an X emulation package in a foreign 
host, such as a PC (see Figure 4-1). 


4.2.3 Software Interfaces 


The software interfaces of Advant Station 500 Series Operator Station system applications are 
not affected by the use of X-terminals except for the functional keyboard. The same 
functionality is provided by the pop-up menu instead (see Section 4.2.1, Pop-up Menus). 


Event and Alarm Handling 


The process alarm lists, process event lists and system alarm list are identical in the 
X Workplace and in the Local Workplace. You can order printouts of lists and pages, but you 
cannot order logging of events, alarms or system alarms for the X Workplace. 


To call up the system list, select the subitem System List in the item System Display Keys in 
the pop-up Operation menu. 


You call up the alarm and event lists by selecting the subitem Alarm List or Event List in the 
item Display Keys in the pop-up Operation menu. 


The lists are available both as base displays and overlap displays. The system alarm list is also 
displayed when you click on the System Alarm List icon in the icon area. 


Process Sectioning 


Call up the Process Section Information display either from the process alarm list, the process 
event list or the system list. 


The Process Section Information display for the X Workplace is identical to the Process Section 
Information display for the Local Workplace with, however, one restriction: 


You cannot log events, alarms or system alarms in the X Workplace. 


Different active delegations can be valid for the Advant Station 500 Series Operator Station and 
the X Workplace. 


4.2.4 Communication Interfaces 
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TCP/IP is used as communication protocol. 
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Chapter 5 Maintenance 


5.1 Preventive Maintenance 


Refer to the documentation accompanying the X-terminals for information about hardware 
maintenance. 


Refer to the AdvaCommand Basic Functions User’s Guide for information about software 
maintenance. 


5.2 Hardware Indicators 


Refer to the documentation accompanying the X-terminals for information about hardware 
indicators. 


5.3 Error Messages 


Refer to the AdvaCommand Basic Functions User’s Guide for information about error 
messages. 


5.4 Fault Finding and User Repair 
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Refer to the AdvaCommand Basic Functions User’s Guide for information about fault finding 
and user repair. 


For information about fault finding and user repair for the X-terminals, refer to the 
accompanying documentation. 


The X Workplace always logs its diagnostic messages in a disk file called 
dcSystem_<workplace>.log where workplace is the name of the X Workplace. In this release, 
the only available workplaces are wp3, wp4 and wp5. The files are placed in a directory called 
/products/log. 
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Appendix A Keyboard Functions 


A.1 Events for specific Advant Station 500 Series Operator Station functions 


The following tables can be used as help lists when you define keys on your own keyboard. 
The functions are the same as are available on the Advant Station 500 Series Operator Station 
functional keyboard. 


Table A-1. Available Keyboard Functions 


Keyboard Function Keyboard Key 


(on Functional Keyboard) Event (on your own keyboard) 
Request for system status display SystemStatusKey 
Request for system list display SystemListKey 
Request for overlap system list display SystemListAsOverlapKey 
Request for configuration display ConfigurationMenuKey 
Request for status list menu display StatusListMenuKey 
Request for status list display StatusListKey 
Request for display menu display DisplayMenuKey 
Request for overlap display menu display | DisplayMenuAsOverlapKey 
Request for alarm list display AlarmListKey 
Request for overlap alarm list display AlarmListAsOverlapKey 
Request for event list display EventListKey 
Request for overlap event list display EventListAsOverlapKey 
Request for left display PageLeftKey 
Request for right display PageRightKey 
Request for previous display PrevDisplayKey 
Request for an object display ObjectDisplayKey 
Request for an overlap object display ObjectDisplayAsOverlapKey 
Request for an object closeup ObjectCloseupKey 
Request for an object trend display ObjectTrendKey 
Request for an overlap object trend ObjectTrendAsOverlapKey 
Request for next dialog key group NextBlockKey 
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Table A-1. Available Keyboard Functions (Continued) 


Keyboard Function 
(on Functional Keyboard) 


Event 


Keyboard Key 
(on your own keyboard) 


Request for the dialog key group above 


PrevLevelKey 


Unselect on selected object 


DialogExitKey 


Input field for display request 


DisplayRequestKey 


Input field for overlap display request 


OverlapDisplay RequestKey 


Input field for object request 


ObjectRequestKey 


Input field for overlap object request 


ObjectCloseupRequestKey 


Select previous object PrevObjectKey 
Request for acknowledge alarm AckKey 
Request for maxdialog MaxDialogKey 
Request for mindialog MinDialogKey 


Dynamic key N (N=1-10) 


DynKeyN (N=1-10) 


Request for silence on audible alarm 


SilenceKey 


Request for hardcopy black and white 


B_WHardcKey 


Request for hardcopy in color ColorHardcKey 
Request for help display HelpKey 
Request for basic display BasicDisplayKey 


Request to increase value with 1% 


SmalllncreaseKey 


Request to increase value with 10% 


LargelncreaseKey 


Request to decrease value with 1% 


SmallDecreaseKey 


Request to decrease value with 10% LargeDecreaseKey 
Request to set value to one OnKey 

Request to set value to zero OffKey 

Request for manual mode ManKey 

Request for auto mode AutoKey 

Request for external1 mode E1Key 

Request for external2 mode E2Key 


Request for the direct selection keys 


DisplaynKeyN (N=1-40) 


A-2 
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A.2 Keysym for the most common Keypad Keys 


Table A-2. Available Keysym Functions 


ee Keysyin (on saa Gaara 
/ KP_Divide 

. KP_Multiply 

+ KP_Add 


- KP_Subtract 
Enter KP_Enter 
KP_Decimal 
0 KP_0 

1 KP_1 

KP_2 

KP_3 

KP_4 

KP_5 

KP_6 

KP_7 

KP_8 

KP_9 


O!;]oO; nN] oO] ay; &] wy] Py 
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